iT邦幫忙

2017 iT 邦幫忙鐵人賽
DAY 27
0
DevOps

不一樣的 CI/CD 工具:Concourse 初探系列 第 27

27 - 自訂資源 (7)

  • 分享至 

  • xImage
  •  

今天要實作做的是自訂資源的 out 部分。不過實際上這次的範例並不會有任何反應,因為我們在前面 API 設計上並沒有做特別的處理。

Out

初始化的部分基本上都是相同的,不過 out 的部分從 STDIN 接收到的參數卻會有一點不同。

require "net/http"
require "json"

input = JSON.parse(STDIN.gets)
source = input["source"] || {}
params = input["params"] || {}
version = "%.1f" % params["version"] || "0.0"

在這邊我們不會收到 version 參數,因為上傳資源並不需要知道版本,而是由伺服器接收之後回傳一個版本資訊。
另一方面,我們需要上傳的話可能會需要一些額外的參數,所以我們可以透過 params 來帶入一些額外的設定參數。

在這個範例,我們可以透過 params 設定要更新的版本。

接下來一樣是建立一個 HTTP 的請求去呼叫我們的伺服器,不過需要調整一下請求的方式。

major, minior = version.split(".")

uri = URI(source["uri"])
query = URI.encode_www_form({major: major, minior: minior})
path = "/v1/version?" << query

res = Net::HTTP.new(uri.host, uri.port).send_request("PUT", path)
response = JSON.parse(res.body)

根據我們的 API 設計,會用 PUT /v1/version 帶入 majorminior 兩個參數傳入來決定要對哪個版本做 touch (修改最後修改時間)的動作。

取得回傳的時間後,我們需要傳回目前所更新的版本讓 Concourse 可以做出對應的動作。而另一方面,和 in 一樣也可以回傳一些 Metadata 讓使用者知道這次上傳的動作有哪些額外的訊息。

updated_at = response["updated_at"] || false

result = {
  "version" => {"version": version },
  "metadata" => []
}

if updated_at
  result["metadata"] << { "name" => "updated_at", "value" => updated_at.to_s }
else
  result["metadata"]<< { "name" => "error", "value" => "No valid version matched!" }
end

STDOUT.puts result.to_json

這邊我們可以將伺服器回傳的更新時間放進 Metadat 中,假設伺服器無法取得時間資訊的話,則回傳一個錯誤訊息。

不過這邊大多數時候都會被 Concourse 快取住,所以在配置版本資訊時可以考慮用 Timestamp 的方式強制觸發。

最後,稍微更新一下我們的 Pipeline 設定檔,加入 put 動作就可以觸發對應的事件。

- put: monster-db
    params:
      version: 2.0

到此為止,我們已經掌握了自訂資源的基本技巧,下一篇會討論一下如何改進以及可以怎麼應用。


上一篇
26 - 自訂資源 (6)
下一篇
28 - 自訂資源 (8)
系列文
不一樣的 CI/CD 工具:Concourse 初探30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言